BEAGLE COMPILER ERROR MESSAGES
------------------------------

Compiled program execution errors:

An Applesoft or ProDOS program error 
will cause a compiled program to crash
just like an uncompiled program. The 
only difference is that compiled prog-
rams produce strange error messages
like:

?ILLEGAL QUANTITY ERROR AT $0ABC.

Uncompiled programs, as you know, prod-
uce messages like:

?ILLEGAL QUANTITY ERROR IN 123.

In this comparison, $0ABC is the hexad-
ecimal location (address) in memory of
the error, and 123 is the line # of
the error (compiled programs have no
line #'s). Since line #'s are easier to
work with than memory locations, the 
most efficient way to trap erros is to
test your programs and get them working
correctly before you compile.


****************************************

Errors found during compiling:

If your Applesoft program contains err-
ors, the Compiler will do its level best
to find them during the compiling proc-
ess. Each offending line will be listed
with the approximate location marked.
The Compiler will then ask:

"CONTINUE WITH ERRORS?"

to see if you want to go ahead and run
the program anyway (some "errors" are 
intentional or cause no problem). If
you answer no, compiling will stop so
that you can edit. Many errors will not
be found by the Compiler-this includes
most ProDOS errors and errors inside
quote marks. Here are some common err-
ors that will be found during compiling:


<?> (SYNTAX ERROR)

o A <?> could mean your program contains
  an Applesoft keyword that is unaccep-
  table to the compiler-specifically 
  CONT,DEL,LIST,LOAD,NOTRACE,RECALL,
  SAVE,SHLOAD,STORE and TRACE. Programs
  with these commands won't compile.
  (Note: ProDOS' LOAD,STORE and SAVE 
  will compile).

o Other culprits are those you have 
  encountered before, such as missing
  parameters (like HPLOT with no coordi-
  nates), type mismatches (like A$=3),
  misspelled keyword (like print), etc.

========================================

<#> (UNDEFINED LINE NUMBER ERROR)

A <#> symbol usually means your progam
used a GOTO or GOSUB to a nonexistent
line number.

========================================

<A> (ARRAY DIMENSION ERROR)

An <A> means your program has illegally
allocated arrays. For example: 

A(25)=3:A(6,3)=3

========================================

<*> (ILLEGAL QUANTITY ERROR)

The only illegal quantities the compil-
er will find are illegal addresses (for
example, POKE 90000,0). Other illegal
quantities (like HPLOT 90000,0) won't 
be noticed until your program crashes.

========================================

INCLUDE APPENDED MACHINE CODE?

This message means the Compiler has
found some extra space at the end of
your program. This could be useless
garbage or it could be valuable data
or a routine that is called by the
program. When unsure play it safe by
answering Y (Yes, to inlude the code.)


****************************************


Keyboard Errors:

These errors may occur immediately after
you type a command:


FILE TYPE MISMATCH

o Maybe you used the same names when 
  compiling a file to disk

o Or you used a command like COMPILE 
  NAME, NEWNAME and NEWNAME was alredy
  on the disk as a type other than COM.

o Or you ran a program that uses CHAIN,
  STORE or RESTORE and you didn't compi-
  le with the COMMON command.

o Or you wrote an Applesoft (BAS)
  STARTUP program. STARTUP must be a
  compiled (COM) file.

========================================

NO BUFFERS AVAILABLE

o You may have tried to install the 
  COMPILER.SYSTEM or COMPILER file more
  than once. One time is enough.

o Or you may have tried to run a program
  below address ($0801).

o Or you may have pressed Cntr-Reset
  during a catalog.

Solution: Try again or Reboot.

========================================

NOT A COMPILED PROGRAM

See Beagle Compiler Dox

========================================

PATH NOT FOUND

Translated: File not found.

========================================

PROGRAM TOO LARGE

o Your Applesoft program is too large to
  fit in memory.

o See Beagle Compiler Dox for xtra k

========================================

?SYNTAX ERROR

o Maybe you spelled a comnand wrong

o Or maybe you used the COMPILE or
  COMMON command w/o installing the 
  Compiler.

o If you get this error in respone to 
  something that you know is correct,
  then memory is probably damaged and
  you should reboot. Try pressing 
  Control-Reset first.


****************************************

Call these cool systems:

The Courtroom Elite......(213)644-2760
Dark Cosmos Elite........(213)476-7678
Alpha Centauri...........(213)838-7726
Mother Board West........(415)994-2758
The Haven................(416)485-7805
Smash*Palace*South.......(512)441-0095
Trans-furs][.............(514)738-1247
Black Forest.............(617)263-9413

(*-Practor Fime-*)